Skip to content

doc: design for user-defined cluster replica sizes#36186

Draft
jubrad wants to merge 1 commit intoMaterializeInc:mainfrom
jubrad:jubrad/cluster-replica-sizes-design
Draft

doc: design for user-defined cluster replica sizes#36186
jubrad wants to merge 1 commit intoMaterializeInc:mainfrom
jubrad:jubrad/cluster-replica-sizes-design

Conversation

@jubrad
Copy link
Copy Markdown
Contributor

@jubrad jubrad commented Apr 21, 2026

Summary

Design document for making cluster replica sizes durable catalog objects with SQL DDL support.

Contents

  • Problem statement: env-var-only sizes require restarts, no ad-hoc experimentation, no safety guarantees
  • Success criteria: no-restart create/drop, SQL visibility, in-use protection, backwards compatibility
  • Solution: durable ClusterReplicaSize catalog object with ClusterReplicaSizeId, builtin sync, CREATE/DROP CLUSTER REPLICA SIZE DDL
  • Alternatives: string key, mutable sizes with drift tracking

🤖 Generated with Claude Code

@jubrad jubrad force-pushed the jubrad/cluster-replica-sizes-design branch from 8355c8e to 8e1303b Compare April 24, 2026 01:35
Design document for making cluster replica sizes durable catalog
objects with SQL DDL support (CREATE/DROP CLUSTER REPLICA SIZE).

Covers: problem statement, success criteria, durable storage design
with ClusterReplicaSizeId, builtin sync, SQL DDL syntax, access
control, credit enforcement, system tables, and alternatives
considered.

Prototype: MaterializeInc#35971

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jubrad jubrad force-pushed the jubrad/cluster-replica-sizes-design branch from 8e1303b to 6b32604 Compare April 24, 2026 01:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant